package com.bzkj.basicinfo.mapper.receive;

import com.bzkj.basicinfo.domain.receive.WmsReceiveOrderEntity;
import org.apache.ibatis.annotations.Param;

import java.util.List;

/**
 * WMS收货单主表Mapper接口
 *
 *@author lixinyu
 * @date 2025-10-22
 */
public interface WmsReceiveOrderMapper {

    /**
     * 查询收货单列表
     *
     * @param entity 收货单信息
     * @return 收货单集合
     */
    List<WmsReceiveOrderEntity> selectReceiveOrderList(WmsReceiveOrderEntity entity);

    /**
     * 根据ID查询收货单
     *
     * @param id 收货单ID
     * @return 收货单
     */
    WmsReceiveOrderEntity selectReceiveOrderById(@Param("id") Long id);

    /**
     * 根据收货单号查询收货单
     *
     * @param receiveOrderNo 收货单号
     * @return 收货单
     */
    WmsReceiveOrderEntity selectReceiveOrderByNo(@Param("receiveOrderNo") String receiveOrderNo);

    /**
     * 新增收货单
     *
     * @param entity 收货单
     * @return 结果
     */
    int insertReceiveOrder(WmsReceiveOrderEntity entity);

    /**
     * 修改收货单
     *
     * @param entity 收货单
     * @return 结果
     */
    int updateReceiveOrder(WmsReceiveOrderEntity entity);

    /**
     * 删除收货单
     *
     * @param id 收货单ID
     * @return 结果
     */
    int deleteReceiveOrderById(@Param("id") Long id);

    /**
     * 批量删除收货单
     *
     * @param ids 需要删除的数据ID
     * @return 结果
     */
    int deleteReceiveOrderByIds(@Param("ids") Long[] ids);

    /**
     * 更新收货单状态
     *
     * @param id 收货单ID
     * @param orderStatus 订单状态
     * @param updateBy 修改人
     * @return 结果
     */
    int updateReceiveOrderStatus(@Param("id") Long id,
                                 @Param("orderStatus") String orderStatus,
                                 @Param("updateBy") String updateBy);

    /**
     * 更新收货数量
     *
     * @param id 收货单ID
     * @param receivedQuantity 已收货数量
     * @param rejectedQuantity 拒收数量
     * @return 结果
     */
    int updateReceiveQuantity(@Param("id") Long id,
                             @Param("receivedQuantity") java.math.BigDecimal receivedQuantity,
                             @Param("rejectedQuantity") java.math.BigDecimal rejectedQuantity);

    /**
     * 查询待验收的收货单列表
     *
     * @param entity 收货单查询条件
     * @return 待验收收货单集合
     */
    List<WmsReceiveOrderEntity> selectPendingInspectOrders(WmsReceiveOrderEntity entity);
}
